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INTRCOUCTION 


SCOFE 


This paper describes the contents of the various job control : 
tables used within the Release 6.0 05/3 Operating System; VUT, 
LUT, SCP, Queue Tables, Job Otrectory, Job Step gibdcee FRE, 
OTR, FUR, JVT, JRT, JSCO, Que ry Tabie, and WCT. 


PURPOSE 


The purpose of this paper “is to describe the above. mentioned 
tablese 


COMPONENT. SUMMARY 


There are various tabtes used by the job control programse These 
tables are summarized belowe ALL system tables are in fite 
“EYSSYSTEMTABLES”~ om SYSRES.» ALL job tables are in the SYS RUN 
file for that job on SYSRUN. 

VUT 

The VUT (Volume Use Tabte) contains information on atl: volumes 
usec by jobs executing or scheduled in the system 

LUT 

The LUT (Logical Unit Table) contains the device type and 
characteristics for every Logical Unit Number. 

SCP 

The SCP contains the queue entries for the active jobs. There 
are two blocks to accomodate 14 job stotse 

QUELE TABLES 

The Queue Tables contain one entry for each job awaiting 
schedulinge There are three Queue Tables, one for each 
scheduling priority.e A queue table entry contains the disk 
address of the JD, the FRB, and the JSCD. 

JD 


The JD (Job Directory) contains the disk address of every 38D. tor 
@ given job. 
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JSD 
The JSD (Job Step Directory) contains disk addresses of the 
infcrmation needed during processing of a single job stepe The 


JSD contains the disk addresses of the FRB, the JRTs FCB“s, 
alters, and imbedded data. ; 


FRB 
The FRB contains various items of job retated information which °~ 


must be maintained on disk throughout a jobs The FRB contains 
the disk addresses of the ORT and JVT. 


ORT 


The DRT Coevice Requirement Tabte? contains information about 
every device used by the job. 


FUR 
The FUR (Facilities for Unit Record) is a compressed form of the 


DPT containing information about only unit record devicese The 
FUR is contained in the same disk record as the FRB. 


JVT 
The JVT (Job Votume Table?) contains information about atl votumes 
used by this job, and about all autoconnect workstationse 

JRT 
The JRT (Job Requirement Table) contains a condensed version of 
the user job streame There ts one JRF for each job step. 

JSCO 


The JSCD (Job Shared Code Directory) contains a List of the 
shared entry points and modules required by the job. 


GUERY TABLE 


The Query Table contains a List of every tabel and job step in 
the job controt. It contains the job step number and JRT entry 
numcter for theme It ts only included if the query option is 
specified. 


WwCT 
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The WCT (workstation Connect Table) contains: Labet and user-id 
infcrmation for use in processing workstation connects and 
disconnectse 


3e HAROWARE REQUIREMENTS 


Any hardware on which O0S/3 can rune 


be INTERFACE DESCRIPTION 
4el RELATED SOFTWARE COMPONENTS 
e121 RUN Processor and OCL Processor 


The Run Processor (or the OCL Processor) creates the job retated 
tables - the JD, JSD, FRB, DRT, JVT, SRT, FSCO, Query Table, and 
WCT. Space tis reserved for the FURe The LUT is reads The - 
resulting job is put into a Queue Table. 


4e1.2 Scheduler 


The scheduler reads the Queue Tables to find a job to schedule. 
It reads the job related tables - FRB. ORT, JVT and JSCD. It 
creates the FUR. It merges the JVT tnto the VUT. It adds the 
scheduled job to the SCP and removes it from the Queue. 


4e1e3 Jcb Step Processor 


The job step processor reads the job related JD, §50 (job step), 
JRT, FRG,» FUR and Query Tablee It updates the VUT as votumes are 
used, At job termination it deletes VUT entries, and removes the 
job from the SCP. 


4.1.4 Qreve Manipulation Utilities 
The HO, BE, CH, DE, DI JBQ@ console commands access the Queue 
Tablese 

4.1.5 SYSGEN 
The system table file is allocated by SYSGEN. The file is on 
SYSRKES with Label “SYSSYSTEMTABLES”™. The relative record number 
of the first record in each table is an EQU in SCSTOEQUs 
The amount of disk space to allocate must be computed. ‘The sep 
requires 2 recordse The LUT requires 4 recordse The number of 


recerds for the VUT is JCSVUBLK which ts an EQU im the JCSTOEQU, 


The number of records for each queue can be computed from user 


ees 
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supplied parameters giving the maximum number of jobs per queue; 
the formula is: 


IF number-of-jobs > QUSEPB then 
number~-of-records = € (number-of-jobts) /QUSEPB ) + 2 
else 
number-of-records = 1. 
There must be at Least one record for each queuee The maximum 
number of jobs for each queue is stored in SIB variables 
SESCOMAX, SBSQIMAX, and SBSQ2MAXs 
These parameters should be selected so as to not waste disk 
spacee The user must note she fotlowing facts when specifying 


these parameters: 


o The first record of each queue table contains 7 job entries. 


o Subsequent records contain 8 job entriese 
ro) There wilt be one record for each queue, even if the maximum 


number of jobs for that queue ts zero. 


o The more tracks allocated to the System Table Fite, the 
greater the system initialization time. 


For examples assuming an 8418 SYSRES (490 records per track): 


#records #Hentries — 
Pre-empt ive 1 7 
High 6 39 
Normat 41 79 
Other tables 22 
40 


If there are muttiple supervisors, SYSGEN must allocate a System 
Table fite with sufficient space to meet the targest 
requirements. 


4.166 Supervisor Initialization 


Supervisor initialization uses the table initialization symbiont 

JLSSTI to initialize SYSSYSTEMTABLES. Table inttialization sets. 
up the VUT, LUT, SCP, and Queue Tables. It puts the disk address 
of the fite in SIB variable SSSSYSDA. 
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4e1e7 Interfaces Required 
Atl interfaces to these tables should be via the OSECT“s provided 
in the JCSTDEQU BROC. 


The CONNECT and FREE processors read the WCT. When a match is 
found, the FCB fs read and written, and the wCT is updatede © 


4e1.9 Other Users 


Other users of these tables not in the job controt area inctude 
the READFCB transcients, the OBTAIN transcient, the EX TEND 
transcient, the ALLOC transcitent, ALTER, SETCS, and the REBUILD 
console commande 


4e2 DATA BASES 


These tables are the Data Base for Job Control. | 


4e3 OPERATOR INTERFACES 


Not applicable. 


464 USER INTERFACES 


Not applicable. 


Se FUNCTIONAL DESCRIPTION 


The tables are contained in either a singte 256 byte disk record 
or in many disk records Linked by a physicat disk address in the 
last four bytes of a record. The LUT and the VUT are not Linked 
and are normally accessed by multi~sector 10. 7 


Access to the tables is normally thru the JCAT subrout ines  JEAT 
uses P1IOCS. JCAT normally reads tables as linked records but 
atso has provision for multi-sector read as indicated in the 
discussion of the JCAT keys in the JSD section betow. 


Most of the tables have DSECTs in the JCSTDEQU. These tables 
have three additional EauU’s in the JCSTDEQUe The one EQU gives . 
the number of bytes in a single table entry. Another gives the. 
numter of entries in a single disk recorde Another EQU gives. the 
numter of bytes used by table entries within a disk record. 
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SYSTEM TABLES 


The system tables are in a ftte on SYSRES with tabet ° ae oS 
“SYESYSTEMTABLES~ This fite is in the VTOC and fs accessed. by | 
PIOCS onlye The disk address of the first record in the file. is 

tn sie variable SB&SSYSDA. 


The relative record number of the first record of each systen. 
table is defined by an EQU in the JCSTDEQU. 


JCSVUTRN VUT 

JCSETORN Pre-emptive queue 
JCSQTIRN High priority queue 
SJCSGTZRN Normal priority queue 
JCESCPRN Scope Slots 1 thru 7 
JCSSCERN Scope Stots 8 thru 14 
JCSLUTRN Logical Unit Table 


JCS FRERN First unused (free) record 


The file is allocated by SYSGEN and initialized by supervisor 
initialization as described in 44766 and 4e1.2.7 abovee 


VUT 


The VUT consists of a sequence of 22 byte entries contained in a 
contiguous (not Linked) disk area of JCSVUBLK recordse The first 
disk address used by the VUT fs at retative record number 
JCSVUTRNe The number of VUT records actuatty in use is 

maint ained in SIB vartable SBSJCVUT. 


The VUT is accessed thru: JCAT with key bSbVUTOO. The DSECT for. 
the VUT is in JCSTDOEQU. oe 


The VUT cescribes volumes and volume devices which are being used. 
or with be used by jobs currently executing or scheduted. When a 
job is scheduled, its JVT is merged with the VUT. When a job 
terminates, a mask is set in the SIBs SBSJCMSK which indicates. 
that VuUT entries for the indicated job stots are invat id... The 
scheduter then clears these entries from the VUT. The. last entry 
in the VUT, which may be a null entry, has the end bit, Boeeenbe 
sets . 


Dynamic get device, GETOVEC;, aiso puts entries in the vuUT. They 
are removed by dynamic free device, FREEDVC. 


JCSVVSN CL6 Votume serial number of the votuse which 
this entry describes. There is only one 











© © © © © @©@ @© 6 6 e 


‘@ 


C) 


JCSVLUN 


SCSVFLG1 


BJSVALC 


BJSVRES 


" BJSVMTWG 


BJSVTBMT 


BJSVONS 


BJSVVNS 


BJSVVN 


BJSVSEC 


SCEVFLG2] 


BJSVID 


BJSVIV 


BJSVPERM 


BJSVSHD 


B JSVEND 


x7 807 


X740° 


x701° 


x7807 


x7407 


x7 107 
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entry with a given VSN in the vUT at any 
timee For inherited votume entries — - 
(BISSVIV set) the VSN is 4 blanks, the 

job slot number, and a sequent iat number. 


DRT number (IVT onty) 

Flag bits as belows 

A pub #s altocated to this ent rye 

A pub is reserved for this ent ry. 

For internal job step processor ise. 
Votume must be mOUn Sede pub is allocated. 


The device deck this volume §s- mounted 

on is not shareabte because another: Si 
wotume will be mounted on the same device 
in a later job step. 


The volume is not shareable because it. | 
wilt be mounted on another device in- a. 
later job step. 


The volume is not Shareabte due to: 
“NS” specified on the // VOL carde 


The volume fs a sequentiat vot ume: in» 
a wgulti-volume fite or ts a resotved 
aiternate or optional device. It is 
not shareable. 


Flag bits as below: 


Inherit device; this votume wi tt be 
used on a device presently Pet ng used” 
by some other Paige ae 


Inherit volume. This: is a dus my entry - 
for a device which witt use a volume : 
currentty on some other device. 


Permanent VUT entry. AR is Vatune 
is a systea volume and $s always 
atlocated to all fob stots. 


This device wiit inherit a vot ume during 
the job step but not at the start. : 
The mount message wilt be issued 

by Data Management, 


This is the last entry tin the VUT. 
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BJSVOPT x*02° Unresolved alternate or optionat votume. 
JCSVONI Cc Device non-shareable index: index 


number (1 to 255) of VUT entry which 
with next use this device. This entry 
has BJSVDNS sete The indexed entry _ 
witl have BJSVIO set and indexes’ peek 
to this entry with pieitore. 


JCEVIOI c Inherét device inde x3: index eked a: . 
to 255) of VUT entry which ts Bievsedaty 
mounted on the device. that this volume 


witl uses. This entry has BJSVID — 


The indexed entry has BJSVONS set and 
indexes this entry with BISVDNIe — 


JICEVVNI C Volume non-shareable index; “index “puebee io 


(1 to 255) of dummy VUT entry for the... 

next device to use this volume. This: 

entry has BJSVVNS sete The indexed 
entry has BISVIV sete . 


JSCSVLBOT Cte Logical device type and subtype 
required by this volumes 

JCSVEFEAT CL2 Features required by this volumes 

JCS VPUB 1 H Reserved pub addresse | 

JCS VPUB2 H Atlocated pub address. ae 

JCSVUCDE CL2 User job bit maske The bit is: set: +e. 


the job requires this volume. “It: is 
cleared when the job no Longer requires 
this volume. If this mask #s zero 

the entry is null. 


LUT 


The Logicat Unit Table consists of. 256 4 byte entries contained: 
in four disk records read with a multi-sector read. The LUT is 
accessed thru JCAT with key BSBELUTOC. Each LUT entry contains 
the device type and characteristics associated with that ovc 
number by SYSGENe 


s cP 


The scope table consists of two block which contain the queue, 
entries for active or rolted out jobse One scope bloc k ts for 
job stots 1 thru 7 and the other is for 8 thru 146 The scp is 
accessed thru JCAT with key ¥S#@SCPOO for the first block and with 
key #S#SC2000 for the second. The DSECT for the SCP #s in the 
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SCSTOEQU. 


JCSSCNAM 7CL9 These 7 entries coaprise the top: 
console Line. Each entry either . 
contains a job name or the empty slot 
number. ; - 


Cc : One byte filler for a 64 byte consote | 
dine. 


JCSSCQUE 7CL CQUSLEN 6) 


These 7 entries contain the. queue 
entries for the active jobs for 
that job slot. Oue to space - 
restrictions, the disk address 

of the JSCD is truncated from 

the queve entryse 


JCSSCNUM PtL2 This contains the stot number 
times ten of the first slot in 
this block. It contains either 
10 or &0. 


Se1e4 Queue Tables 


A Gueue Table consists of a sequence of 30 byte entries 7 
mairtained in the linked record format. The Gueve. Tab Les: are 


entries per queues See Section 4e166 above for discus sion of | 
specification of maximum number of entries per queue. The last: 
entry in the queue, which may be a null entry or may be the 
header entry, has the end bit JBSENDs Sete 


Each queue entry contains information about @ job that has been 
processed by the run processore A job in a queve may be ins 


schedule status job ts awaiting scheduling 


hotd status job was in schedute status but 
now may not be scheduled 


Save status job is awaiting a save to $Y35(CS 
‘by the JLSSSV symbiont 


When a job goes into execution, it is removed from the queues 
The first entry in each queue contains queué information and is 


Not a job entry. This first entry is catted the header entrye 
There are 3 Queue Tables in the system: 


e@T2 Kormal priority queue. 


G¥1 High priority queue. No jobs from the normat 


accessed thru JCAT with keys BSbQTIOG. . There may be up to 32767. 


aTtdg 
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CO. ke 
QUSSPFLG 
S 
JESHNEWR 
s 
@ JBSHNEWL 
& 
® JSESHNEWW 
e 
JESEND 
e JESFIRST 
QUS SPFLG+1 
QUS FAX 
QUS NOENT 
QUSNOACT 


® QUSNOCLR 


GUSRLVSN 
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priority queue will be scheduled if the: high 
priority queue contains any jobs not in 
hold statuse 


Pre-enptive priority quevee No jobs from the. normal 
or high priority queves will be scheduled if ‘the 
pre-emptive priority queue contains any jobs not. 

in hold status. If atl necessary resource Sy except” 
memory, are available, a pre-emptive job | 

witl cause normat and high priority jobs to be ae 
rolted out of memory so as to make memory available, 
if rotlout is configured. 


The DSECT for the QUEUE Tables is in the JCSTDEQU. 


Queue First Entry 


XL2 Queue Flags. 


x7207 | When putting jobs into this 
queue, put jobs from a remote 
source into hotd status. i 
x7107 when putting jobs into this queue, 
put jobs from a tocal spurce pnts 
hold Status: 


x7087 When putting jobs into this _ 
queue, put jobs from a 
workstation into hotd status. 

x “027 This ts the last queue entry. 


x 7017 This is the queue first entrye 


Contains queue number - O, 1, or 2s 
in low 4 bits. 


H Maximum possibile number of jobs 
tn this queue e 


H Current number of entries in this ... 


Queue « 
H Number of entries in this queue 


available to be scheduled - not 
in hold statuse 


H Number of cleared entries in the 
queue. When QUSNOCLR becomes 
equal to QUSEPS the queue is 
compressed. 


CL6 Volume seriat number of the run 
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GUSEOQDA 


Gueue Job Entries 


QUSJBLFEG 
JELREM 


JESSAVE 


JESHLOJB 


“JEZENOSCD 


JESSHARE 
JESROLL 


JBSEND 


QUS JBFLG+1 


JESWKSTN 


QUES JBNAM 


QUSPSTID 


QUSMEFNS2 


GUSDOIF 


QUS FRB 


CL4 


x 7107 


x “047 


x “02° 


x “8G67 
CL8 


CL6. 


CLS 


Library. 


Disk address of ecard containing 
the Last entry in this quevee 


Queue Job flags 
Job is from a remote source. 


Job is to be saved by SAVE 
symbiont. 


Job is in hold status. 


After job is saved, remove it 

from queuee If this bit is clear, 
then teave in queue with JBSSAVE © 
bit cleared. If set the job js 
not inctuded in QUSNOACT count. 

If not set the JBSHLDJB bit 
determines if it is inctuded in 
QUSNOACT. 


Job uses shared code. 
Job is rotled outs 


tast queue entry (may be set tae 
null entryde 


Contains flags in high 


.& bits and queuve- number - 


Os 13 of 2 in Low 4 bits. 
Job is from a workstations 


Job name; if first byte is 
x°O0° this entry is null. 


Master user-ide First. 
byte of x700°, impltes the 
system console. 


Minisum memory size in 256 
byte increments. 


Difference between maxinum and. 
minimum memory sizes from job © 
card in 256 byte incrementse 


Disk address of job“s FRE. 


Bp Se Se eek, de te ee BETS 
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QUS SHARE CLS Disk address of jobs JS CDe 


Zero if job does not used shared 
codee 
QUS STAT H reason code for why the 


jeb did not schedule. 


RUN LIBRARY 


Each job has a run tibrary fite on SYSRUN with babet “ SYSRUN- job. 
name”. This file has two parts: a job control part and a 
Librarian parte The job control part is accessed by PIOCS, 
norsatly by the JCAT subroutines The disk address of the first 
reccrd in the run library is in preasble variabte JPSRLD. 


A job consists of up to 255 job steps. The job directory (503 
contains the disk address of the job step directory (3$D) for 
each job step. The JSD points to tables containing both job and 
job step information. To minimize disk access by the scheduter 
the queue table also contains the FRB disk address. 


Jc 
The JD contains 28 bytes of disk file retevant information | : 
followed by 255 4 byte disk addresses of the JSO0se- The JD is = 
mairtained tn 5 disk records. The first JD record is the first. 


ceccrd in the run Library. 


The format of the first JD blocks 


: bytes ; st : : 
Jo0 (1) 0-3 CL4 Disk address second JD block. 
spot2) 4-7 cL 4 Disk address third Jd block. 
$693) &-11 CL4 Disk address fourth ‘4D block, 
J06 (4) 12-15 cCL4 Disk address fifth Jp block. 
JHSRPT 18 C Run Library pecouae per 

tracke 
JHS TPC 19 C Run Library tracks per - 
cytinder. _ , 
JHSNXTCC 20-23 CL4 Disk address of: ne xt avait- | 
able record in the run: > 
Library. Set to greater. than 
JHSLSTCC if an ext end is 
necessarye . Sg ge 
JHSLSTCC 24-27 CL4 Disk address of Last record 


currently allocated the run 
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SrensssseesezreSs2ee== Serre reassess ese Ses SS Sesser sassssseesese = 
Library. 
28-255 S7CL4 Disk addresses of 3804) thru. 
SS0657) 6 
The format of the second thru fifth JD blocks: 
bytes 
O-227 S7CL4 Disk address of a JSD. . 
COnty the first 108 bytes . 
2? entries are used in the 
fifth JD.) 
228-255 cL_28 Not usede 
JSD 


There is one JSD for each job step. There is always one more JSO- 
thar there are job steps specified in a user program. The last 
JSD is used to close files at the end of a jobe 


The JSO consists of a sequence 14 byte entries maintained in the 
Linked record formate Each JSO entry consists of an 8 byte key: 
names a 4& byte disk address and 2 flag bytese The tast JSD entry: 
is all binary zerose The JSD is normally accessed by JCAT which 
scans the JSD for a given key name in order to obtain the 
necessary disk address. 


The OSECT for the JSD entries, akso called JCAT keys, is in 
JCS TDEQUe : 


JCS KNAME CL8 The keynamee 
JCSKFLG | Cc Flag bytese . 
BJSKDEL x"807 Delete this keys de wilt ner. 
be used in the next job stepe 
BJSKALTR X7407 An alter phase namee 
BJSKMSR x7207 A multi-sector disk access is used 


for the data pointed to by this 
keys The number at sectors is in 
JCSKLNG 


B USKDUP X7107 This is the key for an FCB which. 
is also in the previous JS0. 


BJSKSFCB x7 08” This #s the key for a system 
supplied FCp. 


BJSKSRUN x704 7 Only used if BISKSFCB is sete 
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System file is on RUN device. 


JCSKLNG c Number of Sectors for multi-sector.. 
Otherwise for user uses 


JCSKDISK CLS Disk address of data. . 


The key names in the JSD are of the following types: 


b IJEXX XXX job related tables. 
b JbIRTCO JRT always in each 130. 
b Jb FREOO FRE always in each JSD. 


File LFD Names 
The following LFbD”s are automatically in each JSO0: 
$YSRUN 
fYS$LCD 
SYSSRC 
fYEMAC 
SYSOBJ 
fysucs 


eCeoTAnNn Imbedded data, NN is the binary _ 
data set number within job step. 


Phase name Alter statemente 


Se2e2 FRB 


The FRB contains 88 bytes of informstion about the job. The. 
remaining 168 bytes in the FRB“s disk record contain the FURS 
The FRB is accessed thru the JSD with key BJbFRBOO or direct ty 
froe the disk address in the queue entrye The DSECT for the FRB 
ts in JCSTDEQU.e The comments in this DSECT are self-explanatory. 


5e204 DRT 


The DRT contains up to 255 8&-byte entries ‘maintained fn Linked 
Teccrds.e The DRT is accessed from the JCSEDRT disk address: in 
the FRE. The number of ORT entries for a given job is fn FRB 
entry JCZFORTN. There ts one ORT entry for every device used by 
the job. The DSECT for the ORT is in JCSTDEQU. 


JSCSORLUN Cc In run processor: togical 


ee €@#e @ @ © © @ © @ @ 8 8 ® 
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unit number from DVC statement. 


In run Library: ORT entry 
number on creation. The DRT 
is sorted so these numbers age. 
‘a key for access of ‘the DRTs 
They are used in the JVT, FUR+ 
and JRT-pVC entrye | 


SCSORFLG C . “Flag byte. 
BJSDRALT x780° ALT specified on DVC statement. 
BJSDROPT x40" OPT specified on OVC ‘isienents. 
BJSDRPD x“20° Physical device in 3 CSDRPD, 

specified on DVC statement. - 
BJSDREGU x7107 EQU statement for this LUN. 
BUSDRRES x7087 This device is SYSRESe 
BJSDRFRE x704° Used by fun processors 
BJSDRRUN x“02° This device is SYSRUNs. 


BJSDRSD x°617 Device is shareable-used by 
run processore 


JCSORPD Cte Physicat. device ad. it BusoRPD- 
ts sete If BISORPD- is not: ‘set 
for a work Staion type. entrys 
this field contains the pub - 
address of a connect ed 
workstation or ZETOe 


JCSORTYP CL4 Device type and characteristics 
from LUT CJCSDRLUN). 


Se2e5 FUR 


The FUR ts maintained in the remaining bytes in the. PRBS. disk” 
record.e The FUR contains ane entry for each unit record . ° «. 
(printer, reader, punch)? devices The FUR consists cf a paxinus. 
of 56 3 byte entries. The DSECT for the FUR is ain. (SCSTDEQUS 


JCSFRPUB | cL2 bubo address Ro atbaed by 
scheduler. 
JCSFRORT c _- The DRT number for Linking 


from the JRTF DVC entry 
to the FUR. 
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IVT ie 
The JVT contains up to 255 12-byte entries maintained in tinked 
records. The JVT is accessed from the JCSFIVT disk address in 
the FRE. The SVT contains information on atl votume devices used 
by the jobe The JVT is merged into the VUT by the scheduler. 
The DSECT for the JVT is in JCSTDEQU. 


The JVT entry’s fields have the Same uses as those in the first 
12 btytes of the VUT;s excepts: 


JCSVLUN Cc DRT number for DRT accesse 


JRT 

The JRT consists of a sequence of 16 byte entries maintained. in 
linked recordse The JRT ts accessed thru the JSD with key. 
BsbJRTOC. The JRT contains a condensed version of the users job: 
stream for each job stepe The JRT DSECT“s are in JCSTDEQU. 
JRSISN C Job step numbers 
JRSCOE Cc Code for type of SRT entrys 

1 OVC statement 

2 LFD statement 

3 €XxXEC statement 

4 OPTION statement 

5 SET statement 

6 OPR statement 

7 MTC statement 

8 SKIP statement 

9 FREE statement 

10 PAUSE statement 

11 SCR statement 

12 Alternate LFD for EXEC 

13 RUN,CC statement 

14 RENAME Statement 


15 SFT statement 
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JRSSPAR 


Selel7elt OVC statement 
DVCORT 
DVCVSN 


OVCROD 


CVC FLG 
BJSDRES 


BJISDIGN 


BJSSDVOL 
BJSEDNOV 
BJSORUN 


BJSDRPP 


BJUSDUVSN 


BJSDNIVT 


DVCFLG2 


BJSDCNT 
BJSONCNT 


BJSSPLIT 


BJSDALT 
BJSDOPT 


e 520762 


LFONAM 


LFDFLG 


LFD Statement 


CL14 


CL6 


x“ 80° 


x7407 


x7 207 
x7107° 


X7047 


x7017 


x7807 


x740° 


x7107 


cL8& 


SRT entry intorsat ion. 


DRT entry number. | 
VSN from VOL statements 


Mode characteristics of - 
tape from VOL stat emente 


Flagse 
SYSRES devices. 


Ignore specified on OVC 
statement. 


Is a volume device. 
NOVOL on VOL state mente 
SYSRUN devicee 


Unit record device - FUR. 
entry wttt be createde 


Duplicate VSN. - ‘ 


18 


Volume device which is in 
JVT and SVT (mot RES or RUN}. 


Flag byte. 


Block number feature on VOL 


statement. 


Block number features not 
on VOL statement. 


8415 disk. 


ALT specified on DVC 
statement « 


OPT specified on DVC 
Statement. 


File’s LFD namee 


Flag byte. 
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Cr BJSLSYS x7807 Job step temporary files, 
i BJSCEXT x7207 Do allocation there is an 
af ER@ for this file. 
a BJSLSYSJ — x7087 Job temporary fate. 
BILSLWSTN X7047 workstation device. 
Ca BJSLREPL - x702° On ec36 fron: alte ations.” 
give user RIC option. user 
He atways: is given this option: 
ste if SIB bit BBSLREPL is sete 
iy LFDADR CL4 Disk address of FCBe 
| 
‘a Sele7eds EXEC Statement 
EXPRG cL 8 Program name ~ load module 
= to executes | 
¢ 
@ EXFLG C Flag byte. 
¢ BJS ERUN x7807 Load modute is ie SYSRUN. 
= BJSERBP x7407 EXRBP is vatid.. 
BJSALT x"20° Program is in alternate 
dibrary; fottowitng IRT 
af entry Ccode 12) gives LFD 
nhamee 
« BUSALSFT x7107 SFT followse (same as 
| BJSSHSFT bit) 
m¢ BJSEXCAB x7 08 “ Skip on abnormal terminations 
Skip information #s in the 
« JRT for ne NEXT STEPS — 
EXPRI Cc Execution time Priority 
‘oe EXREP XL3 Relative block Abe in’ i 


Library for loader to: start 2 
searching for program. 


EXEMB x Number of imbedded data 
setse 
e@ 
5.20704 OPTION 


OPTION CL2 Option flags Cbet 8000 
: indicates an alter is 
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present). 
OPTGNAME CL8 Label name of query options 
OPTGUERY C Query option fiagss not .useds 


Seleo7ed SET 
SETCDE c ‘Type of set to perform, 
O01 SETCUPSI set UPSI byte _ 
G2 SETCCOM set 
: Communications 
region 


03 SETDDTE set packed 
decimal date 


04 SETEDTE set EBCDIC date 


05 SETBDTE set binary date 


If SETCUPSTI 


SETPARY c UPSI byte “AND” mask to 
reset selected bitse 


SETPARZ c UPSI byte “OR” mask to set 
selected bitse 
If SETCCOM 


SETPAR1 c Number of bytes to move 
into communications regions 


SETPARZ C Bytes to move into the 
communications reg ions 


If SETDOTE 
SETPAR1 PL4 Packed decimait date to move 
, into JPEDAT for system date. 
@ If SETEDTE 
SETPARI CLé EBCDIC date to move into’ | 


JPSOMDE for tape f ile dates. 


If SETBDTE 





SETPARL 


Se2e7e6 OPR 


eF fF FF ® © © © © KF 


OPRLGTH 
OPRFLG 
OFRFUID 
OPRLUID 
Cc 
C — OPRUIDND 
@ OPRMAS 
Cc 
; OFRCON 
c 
OPRMSG 
C¢ 
Cc 
Cc Secele? MTC 
KTCCDE 
Cc 
Cc 
C@ 
€ 


XL4 


x7807 


x740° 


x7207 
x780° 


X7047 


CLi2 
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Discontinuous binsry data 
to move into JPSOMDB for — 
disk file datese , 


Message: Length. 
Flagse 2 7 | pe 


Fiest 6 characters: in 12 
byte pause (SRT) entry — 
contain workstation 
userid. . 


Second 6 characters in 12 
byte pause €5RT) entry . 
contain workstation 
user-ide 


End of pause CJRT) entedes. 


“SYSMAS° was speci died on se 
the // PAUSE statement. 


“$¥SCON” was spect fied 
on the //PAUSE statemente 


12 bytes of message: I* 
the message Length is greater 
than 12 bytes, the OPRMSG 
field ts successive OPR JIRT 
entries contains the: 
remaining bytes of the 
messages 


Numeric code of MTC 
Operation. 


27 BB space backward blocks 


2f BM space backward tape 
marks 


37 FB space forward blocks) 


3F FM space forward tape 
marks i) 


1F WM write tape marks 
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MTCFCe 


MT CNUM 


Se2e7eS SKIP 
SKP STEP 


SKPJIRT 


SKPBSK 


SKPLFG 


BJSSK PAB 
SKPQTNUM 
SKP ADDR 


SeleleD FREE 


FRE FLES 


BJSFVSN . 


BJSSFLUN - 


BJSFUR 


ci4 


CL 4 


x780° 


CL4 


x7807 


O7 Rt rewind to. load point 
OF RU exviad and untoad 
disk address of. FCBe | 
Nueber of block's oF tape 


marks to be spaced or 
written. 


Job step number to skip te 


JRT entry number within 
jab step to SKIP toe 


Bit maske 


If bit mask is alll zero, 
then skip aati tae tlint bd aed 


if for any bit in ‘the ‘bit. 

mask which #s set, there. fu: 
a corresponding bit in the © 
UPSY byte which ts set; then © 
skip; or , 


otherwise use the next JRT 
entrye 


Flags 


Skip if abnormat termination 
of previous job step. 


Number of query table entries 
to skip over. 


disk address of query. table. 


Flag byte. 
Free a VSN devicee 


Free a device, not just a 
fite on that device. 


Free unit record device. 


a 
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BJUSFFIL 


BJSFALT 


BJSSFWSTN 
FREPTR 


FREVSN 


FRELUN 


Se2e7e1f PAUSE 
PAUSELNG 


OFRFLG 


PAUSEMSG 


Se2elett SCR 


SCRADOR 


SCRFLG 


BJSSCRWF 


BJSSCRWJ 


SCR FUN 


SCRDAT 


x7047 
CL4 


CL6 


CLt2 


CL4 


80 


40 


XL3 


Free a fite, rot a device. 


Free just the alternate — 
dev.ices. 


workStation device e 
Disk address of FCB. 


VSN of device to free. if. 
BISFVSN is set. 


Run processor internat usee 


Lengths of message e 


Flags as shown fine 
Section Sele?e & COPR). 


12 bytes of mesSagee If the. 
message Length ts greater: 
than 12 bytes, the PAUSEMSG 
ftetd in successive PAUSE 
JRT entries contains the 
remaining Bytes of the 
MESS3GE e 


Disk address of FCB to 
scratch. 


Fiag byte. 


Scratch of att step temporary 
fites. 


Scratch of alt job temporary 
fites,. 


Type of scratch. 


x°O0" scratch specific file 
x782° scratch by date : 
X783° scratch by pretix 
X784° scratch by extent 
Cnot implemented) s 


Discont inues binary date 
for scratch by date. 
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SCRPRE 


Selelet2 Alternate Library LFD 


LFDNAM 


LFOFLG 
BJSSHSFT 


LFDADR 


Se2e7et13 RUNy CC 
RUN ENLN 
RUN FLG 


RUNJBNB 


Se2e7e1% RENAME 


RENADR 


REN FILE 


Seefeld SFT 


SFTNAME 


CL8 


CL12 


CL4 


CL9o 


CL8& 


EBCDIC prefix for scratch 
by pretixe ; 


Alternate Library FO. from 
EXEC carde 


Flag bytee 
SfT entry foltowse | 


Disk address of FCBe: 


Length of CALLSYM string 
flags 


CALLSYM strings 

if the string is 

greater than 12 rer ka 
the RUNJBNB fietd- 
successive RUNJRT aeriee 
contains the remaining 
bytes of the stringe 


Disk address of FCe to 
renames 


First 9 bytes of new: t#te 
name. Remaining bytes for 
44 character file name are 
atways on the following 
three JRT entries. 


Entry point nase of a shared 
module which coutd not be | 
extracted from the load — 
module by the run processor, 
(Load modute may not exist.) 
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5208 ISCO 
C 


The JSCD consists of a sequence of 13 byte entries matntained in 
c Linked records. The disk address of the JSCD is im QUSSHARE in 

the jobs queue table entry. The JSCD contains a tist of the. 

shared modules required by the jobe Fotlowing each modute. entry 


( is a tist of atl the entry points in that module. 
The JSCD DSECT #s in the JCSTDEQU. | 
C JCEKDID Cc Entry type indicat or. 
c BJSMDBLK x701° Modules 
BJSEPBLK x7027 Entry pointe 
c 
If sodule: 
C JCSPMDNAM CL8 Name of module. 
c JCSMDLEV on Level. 
@ — «SCSHDLNG cL2 Module Length. 
Cc JCSMDCNT Cc Number of entry pp ints for 
this module. 
€ 
If entry points: 
c JCSEPNAM CL8 Name of entry pointe 
JCSEPADR CLS Relative ahieec< Oto n is. 


point within module. ~ 


5 el ed Query Table 


The query table consists of a sequence of 12 byte entries: . 
mairtained in tinked. recordse The disk address of the query 
table tis in the JRT skip statement entry. The query t able 
contains the job step number and JRT entry nusber tor every Labet 
in the 388 control. 


The query taste. atso contains the job step number for every job 
step referenced by the program name on the EXEC statement. The 
query table DSECT is in the JCSTDEQU, 


QUERYNAM — cL8 Label name or program names 


QUERYFLG Cc Flags. 
BJSCLABL x7807 Label entry. 


~~ nr A &@ 48 A Ff A 
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, BJSQPROG x7407  - Program entry. 
QUERYSTP c ; Job step numbers. . 
Dp QUERYIRT . cL2 . SRT entry number vithin : 
job step. 
» 
Se2e0T0 WCT 
D The WCT consists of a sequence of variable Length erite ies. 
maintained in Linked records. The WoT is accessed directly ‘trea. 
> the disk address put in the preamble at the start of job by 


GETJOB or from the disk address in FRB fietd JCSFWCT. The WCT 
consists of a 28-byte section containing fiile information 

> followed by a sequence of 1i2-byte records containing user connect 
information. The WCT contains workstation data file external 
labeis and other information to aid the CONNECT and FREE 

> processors, which use the WCT to quickly find the desi red FCB- 


The WCT DSECT tis tn the JCSTDEQU. The WCT fite information its. as 
B foltows: 


@ WCTSELG cL1 Flags; see wCTSFL6U 
> below for detajlt 
WCTSLBL CL17 Label name or LFO name” 
> examined by connect. 
WCTSFCB cL 4 FCB disk address (C€CRH)- 
> wCTSTYP cL4 Acceptable type and 
charactertstics fron: 
2 logicat unit. number on 


DVC statement. 


wCTSSTEP cL1 Step number of a FREE 
Statement for this 
file. Connect and FREE 
commands ignore this wWCT 
entry if the actual step 
number is greater than or 
equal to this field. 


WCTSNEXT CLI displacement froe start 
; ef disk btiock to next 
weT entry in the block. 
Zero if no more ent ries 
© ; in this block. 


er | 5 
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C The WCT user td information is as fallows: 
WCTSFLGEU CL1 Fiagse 
C wCBSUID x7807 This is a user id appendage. . 
( wCBSWCT x740° This is a WCT preambles 
WCBSLAST x7207 This is the last entry 
tin the WCTe . ; 
C 
wWCBSOPT x710° Optional correcte 
C wCBSP OC x708 ° A physical device connect. 
C WwCBSUIDC x7604° A user id connect. 
WCBEREC x7027° Required to be connected oe 
C for job to go into execution. 
wCBSMSTR x701° Auto-connect to the master. 
C wCTSUID CL6 The user id of the 
: & connected usere If not 
C a user id connect entrys~ 
a this field is zeroed if. 
| no user is connectede __ 
¢ If a user id connect ©. 
entry, this is the user: td 
that may connect, 
Cc wWCTIPUB CL2 Pub address connected to 
zero is not connect ede 
C WCTSPD cL2 Physical device id for 
physicat device connect 
C WCTEDRT cL 1 DRT entry number. So | 
CONNECT can put connected — 
C pub address fn ORT for. : 
scheduler. 
¢ 
€ 
©@ 
€ 
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PERFCRMANCE 


The new table format will have different processing requirement Se 


The run processors pertormance should not noticeably change. for 
smatl size jobs the scheduler and job step processor shoutd be 
faster due to reduced disk access and improved algorithm. . For 
medium size jobs the scheduler and job step PEQSE SSCS performance 
should be unchanged or slightly faster. 


For large jobs the scheduler and job step processor performance 
should be unchanged or stightty stower. However, these tables 
offer a new capability to accept very large jobs which previously. 
would cause table overftouw. 


COMPATIBILITY 


These new table formats require extensive changes to the 
scheduler and to JCAT. Sose changes to the run processors OcL 
processor, job step processor, SYSGEN, system initial? zation, and 
SETREL are required. Minor changes to all code which searches: 
the job step directory is also requirede” 


The user interface is completely compatible. 


CONVERSION 


Already coverede 


DOCUMENTATION AND SUPPORT 


INTERNAL DOCUMENTATION 

142 Initialization, interface, and use of Run Library 
124E Job Control Access Technique (JCAT) 

178 Job Scheduler 

192 Run Processor 


231 Interstep Processor 


USER DOCUMENTATION 
The following manuats witl have minor addit fons: 
UP-8217 Job Control Programmer Reference 


uPp-2065 Job Control User Guide 
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Inctude upper limits fn Section 10 betow.e 


RESTRICTIONS 
The new table formats will permit the fiotlowing upper atte 
151 NO RURES per user job 
751 vo Lumes for att ts active (Cor ovked bon) in the system 
48 unit record devices per job | 
up to 32767 jobs per queue depending on SYSGEN opt fon 


On warm start with a different supervisor, the maximun nuaber 
jobs per queue of the previous supervisor is useds 


A full track ‘must be altocated for the system table fite and run 
library even though less may be needed. This ts an 08/3 not a 
job controt restriction. 

MAINTAINABILITY AND RELTAR TESTS 

These tables ave no redundancy or cross checkinge | Bk fstture. 
could cause the run processor, schedulers or ‘job: step. ‘processor 
to abnormally terminate; or could cause the user job to execute | 
erroneously. This ts no change from the previous vers ions. 


RELATED DOCUMENTS 


See Section Dele 


STANDARD DEVIATIONS 


None knowne 
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